SGWriteMovieData(IM: QC)

Inside Macintosh: QuickTime Components /

Chapter 6 - Sequence Grabber Channel Components / Sequence Grabber Channel Components Reference

Functions / Utility Functions for Sequence Grabber Channel Components

SGWriteMovieData
The SGWriteMovieData function allows your channel component to add data to a movie.
pascal ComponentResult SGWriteMovieData (SeqGrabComponent s,
                                        SGChannel c, Ptr p, 
                                        long len, long *offset);
s
Contains a component instance that identifies the sequence grabber component that has connected to your channel component. The sequence grabber component provides this value to your channel component when it calls your SGInitChannel function (described on page 6-36).
c
Identifies the connection to your channel.
p
Specifies the location of the data to be added to the movie.
len
Contains the number of bytes of data to be added to the movie.
offset
Contains a pointer to a long integer that is to receive the offset to the new data in the movie. The sequence grabber component returns an offset that is correct in the context of a movie resource, even if the movie data is currently stored in memory. That is, if the movie is in memory, the returned offset reflects the location that the data will have in a movie on a permanent storage device, such as a disk.

DESCRIPTION
The SGWriteMovieData function behaves differently depending upon when you call it. If you call it from your SGWriteSamples function, this function writes the movie data to the device that contains the recording operation's movie file. If you call this function at other times, it may write the movie data to a movie in memory, depending upon the recording options that are in effect.

RESULT CODES
File Manager errors
Memory Manager errors